home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / door / twaders3.zip / TRADERS.DOC < prev    next >
Text File  |  1991-07-22  |  18KB  |  438 lines
  1. ***************************************
  2. *  TRADERS.DOC                        *
  3. *  (C) Copyright 1991  Bill Rathbone  *
  4. *  All Rights Reserved                *
  5. ***************************************
  6.  
  7. Welcome Traders...
  8.  
  9.   This program is a utility for use with "Trade Wars 2002"
  10. which is a "door" game, written by ...
  11.  
  12.           Gary & Mary Ann Martin  (C) Copyright 1990,1991         
  13.           Brought to you by Martech Software, Inc. (tm)           
  14.           Support BBS's (913) 842-0300 & (913) 832-0248
  15.  
  16. ...and is an excellent piece of software which has captivated me
  17. for hours on end while logged onto my favorite BBS (User to User,
  18. Dallas 214-492-6565 or 214-492-5695).  
  19.    The TRADERS utility was written from the "Trade Wars 2002" players  
  20. point of view and is designed to help in the collection and 
  21. organization of information you are bombarded with during the game.  
  22. Each time you move from sector to sector, the information that is 
  23. presented will vary from simply the sector number and a list of 
  24. available warps, to ports, beacons, planets, traders, aliens, 
  25. ferrengi, mines, fighters etc.  In addition, you have information 
  26. such as Trader and Alien rankings and personal information
  27. concerning your ship, holds, optional equipment, credits, shields,
  28. fighters etc.   This program will process all of the information
  29. into an organized print-out that you can use when you're online
  30. playing the game.
  31.  
  32.                                                     
  33.  
  34. INSTRUCTIONS (SHORT VERSION):
  35. ******************************
  36.  
  37.   This section is for those users who can't stand to read 
  38. documentation!
  39.  
  40.   To start from scratch, play Trade Wars 2002 with 'Session
  41. Capture' ON.   In Qmodem the command is CTRL-HOME; this will create
  42. a text file in the Qmodem directory called CAPTURE.CAP.
  43.  
  44.   Run INITDATA to create the main file, then run TWUPDATE to read the
  45. CAPTURE.CAP file and extract the useful information.  Next run
  46. TRADERS.  Select 'A' from the main menu to analyze the information
  47. and create your PLAY SHEET.  Then select 'P' (Print/View Play sheet)
  48. from the main menu and it's done!   If you have notes you've been
  49. collecting you can enter them using the Edit/Update function.
  50.  
  51.   I recommend you create a separate directory for 'TRADERS'
  52. files since it may occupy approximately 500 KB of your hard drive.  
  53. You will need to copy (or move) the CAPTURE.CAP file to this directory.
  54.  
  55.  
  56. HINTS:
  57. ******
  58.  
  59.   Holographic Scanners and EtherSpace Probes are well worth their
  60. cost now, since all the information they gather will be put to good
  61. use.  Density scanners are basically worth what you pay for them!
  62.  
  63.   Take note, when reading the Class A, B, C, and Other port list,
  64. if the combination is not listed twice (example 1 to 2 AND 2 to 1)
  65. then it has NOT been determined that you can warp both ways!!
  66.  
  67.   When using EtherSpace Probes, use your ships 'C' computer's 'F'
  68. command to test the distance between where you are launching the
  69. probes and their destination.  Compare the warps, with your Known
  70. Universe on the PLAY SHEET and search for destinations that yield
  71. maximum knowledge!
  72.  
  73.  
  74. THE PLAY SHEET
  75. **************
  76.  
  77.   The PLAY SHEET is the final output of the TRADERS System. After
  78. displaying the header with the copyright notice, it begins with the
  79. Star Dock Location, followed by the three (3) Class 0 port
  80. locations, if known.
  81.    Next, a listing of 'Fortified' Sectors, which is any sector that
  82. contained fighters and/or mines.
  83.    The next three category require some explanation. 
  84. They are:
  85.  
  86.                  Class A trading port combo's
  87.                  Class B trading port combo's
  88.                  Class C trading port combo's
  89.  
  90.   A Class A trading port combo is defined as two adjoining ports,
  91. one of which is buying Organics and selling Equipment, and the
  92. other is selling Organics and buying Equipment. This combination
  93. usually yields the fastest rate of net credits growth, thus the
  94. title Class A.
  95.  
  96.   A Class B trading port combo is defined as two adjoining ports,
  97. one of which is buying fuel ore and selling Equipment, and the
  98. other is selling fuel ore and buying Equipment. This combination
  99. usually yield the second fastest net rate of credits growth, thus
  100. the title Class B.
  101.  
  102.   A Class C trading port combo is defined as two adjoining ports,
  103. one of which is buying fuel ore and selling Organics, and the other
  104. is selling fuel ore and buying Organics. This combination usually
  105. yield the third fastest net rate of credits growth, thus the title
  106. Class C.
  107.  
  108.   These three categories are followed by a 'Listing of other
  109. adjoining ports' which is a listing of all side by side ports that
  110. were not listed in one of the first three lists.
  111.  
  112.   The next listing is of all known ports and their sector numbers
  113. (NOTE: this list is written two across).
  114.  
  115.   All known planets and the sector number where they are located
  116. are listed next.  Next is list of any trader (other then
  117. yourself) who's have been spotted in your travels.  Depending on the
  118. length of the traders name, this listing usually includes the
  119. amount of fighters the trader had with him when spotted.
  120.  
  121.   A similar listing follows with sightings of Aliens and Ferrengi.
  122.  
  123.   Next a general listing of all known sectors (Your Known
  124. Universe) is written 4 across.
  125.  
  126.   The next 3 listings may or may not be on your play sheet. The
  127. first two are listings of 'Evil' traders and 'Evil' aliens and
  128. their ship types.  These will only appear if during your game play
  129. you viewed the 'Ranking Traders' and the 'Ranking Aliens' screens
  130. from your ship's computer.  Remember, these must be listed according
  131. to 'V'alue not 'T'itle for this function to work properly!  The
  132. third and final listing is a copy of the 'I'nformation display
  133. called from the main command prompt.  This includes your alignment,
  134. points, rank, and various ship information.
  135.  
  136.   The PLAY SHEET ends with a wish of good luck and a friendly
  137. reminder to register.
  138.  
  139.  
  140.  
  141. ****************************************************************
  142. ****************************************************************
  143.  
  144.  
  145. THE INSTRUCTIONS IN DETAIL
  146. **************************
  147.  
  148.  
  149. BASIC PROCESS:
  150. **************
  151.  
  152.  Three (3) EXE files form the TRADERS System:
  153.  
  154.           INITDATA.EXE
  155.           TWUPDATE.EXE
  156.           TRADERS.EXE 
  157.  
  158.   INITDATA.EXE - This file creates the TRADEWAR.DAT Database
  159. file which stores various information on the 1000 sectors in your 
  160. Trade war Universe. It is only run once, for each game.
  161.  
  162.   TWUPDATE.EXE - This file reads the session capture text file
  163. of your game play and sorts and organizes the information into   
  164. a useful format.
  165.  
  166.   TRADERS.EXE - This is the main program and is used to view,
  167. print, update, edit, etc the information collected by TWUPDATE, but
  168. the biggest function performed is the preparation of the PLAY     
  169. SHEET.   The Play Sheet is the end result of a multi-level          
  170. analysis and collection of all the information available          
  171. into a simple to read, ready to use complete report of            
  172. your universe.
  173.  
  174.  
  175. CONVENTIONS:
  176. ************
  177.   Any screen that offers a choice of functions can be handled
  178. in any of the following ways:
  179.      1. Click on your selection using your mouse.
  180.      2. Tab between function boxes to your selection,
  181.         when selection is 'current' hit ENTER.
  182.      3. Use the assigned 'HOT KEY'. Hot keys are single
  183.         letters that when pressed will make the selection.
  184.         Hot keys will be highlight in a different color,
  185.         example...'O' for ' OK ' or 'P' for ' Print'.
  186.  
  187.   During the course of this document the phrase 'Click' will serve
  188. to mean any of the above methods of selection.
  189.  
  190.  
  191. INITDATA.EXE:
  192. **************
  193.  
  194.   This program should only be run once for each game being tracked!
  195. (If more then one game is being tracked at one time it will be
  196. necessary to maintain a second sub-directory and a second copy of
  197. the TRADERS files.)   When you run the INITDATA program you will be
  198. presented with an opening screen which will tell you of the
  199. impending file creation and give you an estimate of the size.  Click
  200. 'OK' , to advance to the main screen which will present you with
  201. additional information and present you with a choice to CONTINUE ?.
  202. This prompt must be answered with either a 'Y' for Yes or 'N' for
  203. No.  No, will terminate the program and return you to DOS without
  204. further action. Yes, will begin the creation of the main database
  205. file TRADEWAR.DAT, which will store information of the 1000 sectors
  206. contained in your current TRADE WARS 2002 universe. Once the file
  207. is created, this program will end and will no longer be used for
  208. the duration of your game.
  209.  
  210.  
  211. TWUPDATE.EXE:
  212. *************
  213.  
  214.   This program will read your CAPTURE.CAP file and gather various
  215. bits of information as it finds them.  (NOTE: It is not necessary to
  216. do any prepping of the CAPTURE.CAP file, since TWUPDATE will simply
  217. ignore any misc lines, like the ansi screens etc...) This
  218. information will be stored in your main database file TRADEWAR.DAT.
  219. ( Also if available within your capture file, TWUPDATE will extract
  220. your user Information ( Command from maim prompt: I ) and save to
  221. a separate file, USERINFO.DAT.  Evil traders information will be
  222. stored in a file 'BADGUYS.DAT' if you have viewed the 'Ranking
  223. Traders...' screen from your onboard computer during game play. 
  224. ( From the main command prompt type 'C L V'  NOTE: Don't let the 
  225. [PAUSE] stay on screen too long...)   Also, evil aliens will be
  226. tracked in a file named 'BADALIEN.DAT' if the 'Ranking Aliens...'
  227. screen has been viewed ( Commands from main prompt 'C H V')   NOTE:
  228. You must list these screen by V for Values, not T for Titles).  
  229. When completed, TWUPDATE will inform you how may files in the main
  230. database were updated and will then terminate.
  231.  
  232.  
  233. TRADERS.EXE:
  234. ************
  235.  
  236.   This is the main program, from here you can perform a variety of
  237. functions with the main database, the PLAY SHEET and with this
  238. documentation file.   When run, the opening screen will present you
  239. with a reminder that this is the third file in the TRADERS
  240. trilogy and offer you two selections, Continue and Exit.  Clicking
  241. EXIT will terminate the program and return you to DOS;  clicking
  242. CONTINUE will present you with the main menu, shown below, from
  243. which all other functions can be called.
  244.  
  245.                  ╔═══════════════════════════════════╗
  246.                  ║       Traders v1.0 Main Menu      ║
  247.                  ╠═══════════════════════════════════╣
  248.                  ║                                   ║
  249.                  ║   Introduction                    ║
  250.                  ║   Enter/Update Sectors            ║
  251.                  ║   Analyze/Prepare Play Sheet      ║
  252.                  ║   Print/View Play Sheet           ║
  253.                  ║   View Sector(s) by Number        ║
  254.                  ║   Printing the Documentation      ║
  255.                  ║   Registration Information        ║
  256.                  ║                                   ║
  257.                  ║   Quit                            ║
  258.                  ╚═══════════════════════════════════╝
  259.  
  260. NOTE: A brief description of each Menu Item will be displayed at
  261. the bottom of the screen.
  262.  
  263. Following is a description of each Menu Item in order:
  264.  
  265. ╔═══════════════╗
  266. ║ INTRODUCTION: ║
  267. ╚═══════════════╝
  268.  
  269.   Can be selected by: Clicking with mouse,
  270.                       Pressing I,
  271.                       Highlight using arrow keys and press ENTER.
  272.  
  273.   This selection displays in a scrollable window an introduction
  274. letter for you to view and read. After reading this once (or so)
  275. this menu item will serve no further purpose.
  276.  
  277. ╔═══════════════════════╗
  278. ║ ENTER/UPDATE SECTORS: ║
  279. ╚═══════════════════════╝
  280.  
  281.   Can be selected by: Clicking with mouse,
  282.                       Pressing E,
  283.                       Highlight using arrow keys and press ENTER.
  284.  
  285.   This selection allows you to modify the information stored in
  286. your database sector by sector.  A pop-up window will contain a
  287. blank sector form with the cursor at the 'SECTOR NUMBER' field.
  288. Enter any sector number from 1 to 1000 and press ENTER.
  289. Immediately, the contents of that sector record will be shown in
  290. the sector form.  You may now edit this record with your new
  291. information, pressing ENTER at any field you wish to leave
  292. unchanged.  After the final field has been edited you will be asked
  293. to CONFIRM SAVE ? before the actual database is updated.  Pressing
  294. ENTER, without entering 'Y' or 'N' will be the same as answering no
  295. and the changes will be discarded and you will return to the
  296. main menu.  'Y' (for yes) will save the new sector information to
  297. the database, before returning you to the main menu.
  298.  
  299. ╔═════════════════════════════╗
  300. ║ ANALYZE/PREPARE PLAY SHEET: ║
  301. ╚═════════════════════════════╝
  302.  
  303.   Can be selected by: Clicking with mouse,
  304.                       Pressing A,
  305.                       Highlight using arrow keys and press ENTER.
  306.  
  307.   This selection presents you with a brief message telling you that
  308. this process may take some time and offers two choices,
  309. Continue and Exit.  EXIT will return you to the main menu without
  310. preparing your PLAY SHEET.  CONTINUE will begin the analytical
  311. process, which includes the reading and sorting of various bits of
  312. information.  Each step creates a temporary file to store its
  313. findings.  The entire process will create 17 files;  as each
  314. step occurs, you will be kept informed with screen messages.  
  315. After the data is processed, this function will begin to create
  316. your PLAY SHEET;  once completed, you will be prompted to press
  317. ENTER to begin a quick clean up procedure which will delete the 17
  318. temporary files, after which pressing ENTER again will return you
  319. to the main menu.
  320.  
  321. ╔════════════════════════╗
  322. ║ PRINT/VIEW PLAY SHEET: ║
  323. ╚════════════════════════╝
  324.  
  325.   Can be selected by: Clicking with mouse,
  326.                       Pressing P,
  327.                       Highlight using arrow keys and press ENTER.
  328.   This selection presents you with a prompt window, giving you
  329. some brief information and offering 3 selections, VIEW, EXIT and
  330. PRINT.   VIEW will be active and can be selected by simply pressing
  331. ENTER.  This will present you with a scrollable window containing
  332. the PLAY SHEET which you may read by using the arrow keys.  This
  333. window can also by moved or resized.   Pressing ESCAPE will return
  334. you to the main menu.
  335.   Choosing EXIT in the prompt window will return you to the main
  336. menu.  Choosing PRINT will immediately send the PLAY SHEET file 
  337. to your printer (NOTE: Be sure your printer is ready to go!)  
  338. The average PLAY SHEET is 3-4 pages long but will grow as the 
  339. game advances!  You should have this print out in hand the next 
  340. time you play TRADE WARS 2002.  The individual items on
  341. the play sheet will be discussed in more detail after the menu
  342. section of this document.
  343.  
  344. ╔═══════════════════════════╗
  345. ║ VIEW SECTOR(S) BY NUMBER: ║
  346. ╚═══════════════════════════╝
  347.  
  348.   Can be selected by: Clicking with mouse,
  349.                       Pressing V,
  350.                       Highlight using arrow keys and press ENTER.
  351.  
  352.   This selection, using a pop-up window, will prompt you for a
  353. sector number; enter a number from 1 to 1000 and the complete
  354. sector record will be displayed (Similar to the Enter/Update
  355. function but without editor functions.)   You will also be
  356. prompted ANOTHER ?; pressing ENTER is the same as YES and you 
  357. will be prompted for the next sector number.  'N' (for no) will 
  358. return you to the main menu.  At the ANOTHER ? prompt you may enter 
  359. a valid sector number between 1 and 1000 and bypass the next prompt.
  360.  
  361. ╔═════════════════════════════╗
  362. ║ PRINTING THE DOCUMENTATION: ║
  363. ╚═════════════════════════════╝
  364.  
  365.   Can be selected by: Clicking with mouse,
  366.                       Pressing D,
  367.                       Highlight using arrow keys and press ENTER.
  368.  
  369.   This selection will present you with a prompt window with a short
  370. message and 3 selections, VIEW, EXIT and PRINT.  These functions are
  371. exactly like the ones in the 'Print/View PLAY SHEET' menu item,
  372. except they deal with this file 'TRADERS.DOC'.  Your choices and
  373. options are the same.
  374.  
  375. ╔═══════════════════════════╗
  376. ║ REGISTRATION INFORMATION: ║
  377. ╚═══════════════════════════╝
  378.  
  379.   Can be selected by: Clicking with mouse,
  380.                       Pressing R,
  381.                       Highlight using arrow keys and press ENTER.
  382.  
  383.   This selection presents you with a pop-up window that
  384. contains a short message on registering this program and the
  385. address to send your register form to. ( Please use the
  386. REGISTER.FRM provided.)
  387.  
  388. ╔═══════╗
  389. ║ QUIT: ║
  390. ╚═══════╝
  391.  
  392.   Can be selected by: Clicking with mouse,
  393.                       Pressing Q,
  394.                       Highlight using arrow keys and press ENTER.
  395.  
  396.   This selection will terminate the program and return you to DOS.
  397. You may also simply press ESCAPE to exit the program.
  398.  
  399. ******************************************************************
  400.  
  401.  
  402. SHAREWARE NOTICE:
  403. ******************
  404.  
  405.   This program is result of many, many hours, days, weeks of
  406. programming time and is distributed as Shareware which means that
  407. this is not a 'crippled' version, but a fully-operational program
  408. that you may use for an evaluation period of 10 days.  If you use 
  409. it past this evaluation period, you are expected to register your 
  410. copy with the author.  Registration cost $15.00 U.S. funds.  
  411. You are encouraged to share these files with others and to upload 
  412. an unmodified copy of the TRADERS.ZIP file to other BBS Systems. 
  413.  
  414.  
  415. GENERAL INFORMATION:
  416. ********************
  417.  
  418.   The TRADERS program was written using TURBO PASCAL 6.0 on
  419. a 286 clone, running DOS 5.0, with 4 megs of ram, and a VGA
  420. monitor.  At the time of the initial release of this program, this
  421. is the only system it has been tested on.  If you experience
  422. problems on your system please notify me immediately, at the 
  423. above BBS!
  424.  
  425.  
  426. DISCLAIMER:
  427. ***********
  428.  
  429.  Your use of these programs is completely at your own risk, and the
  430. author assumes no responsibility of any kind.
  431.  
  432.  
  433. Enjoy the game!
  434. *****************************************************************
  435. *****************************************************************
  436.  
  437.  
  438.